<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
	<TITLE>Manuel d'utilisation</TITLE>
	<META NAME="GENERATOR" CONTENT="OpenOffice.org 3.0  (Linux)">
	<META NAME="CREATED" CONTENT="20090517;15083400">
	<META NAME="CHANGED" CONTENT="20090517;16394500">
	<META NAME="Info 1" CONTENT="">
	<META NAME="Info 2" CONTENT="">
	<META NAME="Info 3" CONTENT="">
	<META NAME="Info 4" CONTENT="">
	<STYLE TYPE="text/css">
	<!--
		H1.titre-2-western { font-family: "Liberation Serif", serif; font-size: 18pt; text-align: center }
		H1.titre-2-cjk { font-family: "DejaVu Sans"; font-size: 18pt; text-align: center }
		H1.titre-2-ctl { font-family: "DejaVu Sans"; font-size: 18pt; text-align: center }
		P.titre-3-western { font-family: "Liberation Serif", serif; font-size: 14pt; font-weight: bold; text-align: left }
		P.titre-3-cjk { font-family: "DejaVu Sans"; font-size: 14pt; font-weight: bold; text-align: left }
		P.titre-3-ctl { font-family: "DejaVu Sans"; font-size: 14pt; font-weight: bold; text-align: left }
		P.titre-3-western { font-family: "Liberation Serif", serif; font-size: 14pt; font-weight: bold }
		P.titre-3-cjk { font-family: "DejaVu Sans"; font-size: 14pt; font-weight: bold }
		P.titre-3-ctl { font-family: "DejaVu Sans"; font-size: 14pt; font-weight: bold }
		H1.titre-2-western { font-family: "Liberation Serif", serif; font-size: 18pt; text-align: center }
		H1.titre-2-cjk { font-family: "DejaVu Sans"; font-size: 18pt; text-align: center }
		H1.titre-2-ctl { font-family: "DejaVu Sans"; font-size: 18pt; text-align: center }
	-->
	</STYLE>
</HEAD>
<BODY LANG="fr-FR" DIR="LTR">
<H1 CLASS="titre-2-western"><A NAME="Top"></A>Outil de gestion de
l'architecture à plugins</H1>
<H1 ALIGN=CENTER STYLE="page-break-before: always">Manuel
d'utilisation</H1>
<P CLASS="titre-3-western"><BR><BR>
</P>
<P CLASS="titre-3-western">Sommaire</P>
<OL>
	<LI><P><A HREF="#1">Pour commencer</A></P>
	<LI><P><A HREF="#2">Utilisation</A></P>
	<LI><P><A HREF="#3">Fonctionnalités</A></P>
	<LI><P><A HREF="#4">Création d'un plugin personnalisé</A></P>
	<LI><P><A HREF="#5">Documentation du code source</A></P>
</OL>
<P><BR><BR>
</P>
<P CLASS="titre-3-western"><A NAME="1"></A>1. Pour commencer</P>
<P>Cet outil est un gestionnaire de plugins. Il permet de
sélectionner les plugins que l'on souhaite activer, ainsi que de
configurer des relations entre ces plugins afin qu'ils puissent
communiquer entre eux.</P>
<P>L'interface homme-machine se présente sous la forme d'une simple
fenêtre graphique constituée de trois menus et d'une zone de texte.</P>
<P><A HREF="#Top">[revenir en haut de la page]</A></P>
<P><BR><BR>
</P>
<P CLASS="titre-3-western"><A NAME="2"></A>2. Utilisation</P>
<P>Au démarrage de l'application, les plugins dont le descripteur
est placé dans le répertoire par défaut (<FONT FACE="FreeMono, monospace">plugins/</FONT>)
sont automatiquement chargés. Il est toutefois possible d'ajouter
manuellement des plugins supplémentaires placés dans une archive
<FONT FACE="FreeMono, monospace">.jar</FONT> (menu «&nbsp;Fichier&nbsp;»
&gt; «&nbsp;<A HREF="#Chargement de plugins">Chargement de
plugins</A>&nbsp;»).</P>
<P>Après avoir sélectionné quels sont les plugins que l'on
souhaite utiliser (menu «&nbsp;Fichier&nbsp;» &gt; «&nbsp;<A HREF="#Configuration des plugins">Configuration
des plugins</A>&nbsp;»), on peut lancer leur exécution (menu
«&nbsp;Exécution des plugins&nbsp;» &gt; «&nbsp;<A HREF="#Démarrer les plugins">Démarrer
les plugins</A>&nbsp;»). 
</P>
<P>Une fois la tâche effectuée, on peut arrêter ces plugins (menu
«&nbsp;Exécution des plugins&nbsp;» &gt; «&nbsp;<A HREF="#Arrêter les plugins">Arrêter
les plugins</A>&nbsp;») ou simplement fermer l'application.</P>
<P><A HREF="#Top">[revenir en haut de la page]</A></P>
<P><BR><BR>
</P>
<P CLASS="titre-3-western"><A NAME="3"></A>3. Fonctionnalités</P>
<UL>
	<LI><P>menu Fichier</P>
	<UL>
		<LI><P><A NAME="Chargement de plugins"></A>Chargement de plugins
		(raccourci : <FONT FACE="FreeMono, monospace">Ctrl+L</FONT>) :
		ouvre une fenêtre de sélection de l'archive <FONT FACE="FreeMono, monospace">.jar</FONT>
		contenant les plugins que vous souhaitez ajouter à l'application.</P>
		<LI><P><A NAME="Configuration des plugins"></A>Configuration des
		plugins (raccourci : <FONT FACE="FreeMono, monospace">Ctrl+C</FONT>)
		: ouvre le panneau de configuration ; c'est ici que l'on
		sélectionne les plugins que l'on souhaite exécuter, ainsi que les
		plugins devant être attachés à ce plugin.</P>
		<LI><P>Quitter (raccourci : <FONT FACE="FreeMono, monospace">Ctrl+Q</FONT>)
		: ferme l'application ainsi que les éventuels plugins en cours
		d'exécution.</P>
	</UL>
	<LI><P>menu Exécution des plugins</P>
	<UL>
		<LI><P><A NAME="Démarrer les plugins"></A>Démarrer les plugins
		(raccourci : <FONT FACE="FreeMono, monospace">Ctrl+S</FONT>) :
		démarrage des plugins sélectionnés ; il est impossible de
		redémarrer ou de modifier la configuration des plugins tant que
		l'on a pas arrêté l'exécution précédente.</P>
		<LI><P><A NAME="Arrêter les plugins"></A>Arrêter les plugins
		(raccourci : <FONT FACE="FreeMono, monospace">Ctrl+X</FONT>) :
		arrêt de tous les plugins précédemment démarrés.</P>
	</UL>
	<LI><P>menu «&nbsp;?&nbsp;»</P>
	<UL>
		<LI><P>Aide : accès à ce manuel.</P>
		<LI><P>A propos : informations sur le programme et ses
		développeurs.</P>
	</UL>
</UL>
<P><A HREF="#Top">[revenir en haut de la page]</A></P>
<P><BR><BR>
</P>
<P CLASS="titre-3-western"><A NAME="4"></A>4. Création d'un plugin
personnalisé</P>
<P>Il existe deux manières de concevoir un nouveau plugin :</P>
<UL>
	<LI><P>La première consiste à écrire le code java directement en
	respectant l'interface du type de plugin souhaité, à savoir
	«&nbsp;PluginEntree&nbsp;», «&nbsp;PluginSortie&nbsp;» ou
	«&nbsp;PluginTransformateur&nbsp;». Pour que le plugin soit
	accepté par le gestionnaire, il faut lui associer un descripteur
	XML qu'il faudra alors placer dans le dossier <FONT FACE="FreeMono, monospace">plugins/</FONT><FONT FACE="Liberation Serif, serif">.</FONT></P>
	<LI><P>La seconde méthode exploite un plugin de conception
	assistée, disponible (normalement) dans le <A HREF="#Configuration des plugins">panneau
	de configuration</A>, sous le nom de «&nbsp;Concepteur&nbsp;». Ce
	wizard, associé à ses plugins de sortie «&nbsp;GenerateurCode&nbsp;»
	et «&nbsp;GenerateurDescripteur&nbsp;» permettra respectivement de
	générer le code et le descripteur XML. Le code étant minimal, il
	faudra tout de même le compléter afin d'obtenir l'action désirée.
	Le plugin nouvellement créé sera disponible après le redémarrage
	(et donc le rechargement des plugins) de l'application.</P>
</UL>
<P>Quelle que soit la méthode employée pour créé le nouveau
plugin, il faudra s'assurer que le <FONT FACE="FreeMono, monospace">.class</FONT>
généré est dans le build path, et que le plugin dispose bien d'un
descripteur XML dans le dossier <FONT FACE="FreeMono, monospace">plugins/</FONT><FONT FACE="Liberation Serif, serif">.</FONT></P>
<P><A HREF="#Top">[revenir en haut de la page]</A></P>
<P><BR><BR>
</P>
<P CLASS="titre-3-western"><A NAME="5"></A>5. Documentation du code
source</P>
<P>Si le site a été au préalable généré correctement par Maven
(commande <FONT FACE="FreeMono, monospace">mvn site</FONT>), il sera
disponible <A HREF="target/site/index.html">-ici-</A>.</P>
<P><A HREF="#Top">[revenir en haut de la page]</A></P>
<P><BR><BR>
</P>
</BODY>
</HTML>
